home *** CD-ROM | disk | FTP | other *** search
/ Power Bytes: Money & Finance / PowerBytes Money and Finance CD-ROM 01 / PowerBytes Money and Finance CD-ROM 01.iso / Text / addlaserprep.sit aug88 / AddLPrep docs next >
Encoding:
Text File  |  1988-07-22  |  7.7 KB  |  160 lines  |  [TEXT/MACA]
  1. AddLPrep v1.1 Documentation  7/22/88
  2.  
  3. Apple's LaserWriter system allows a user to get a complete PostScript 
  4.  disk file (including the library code from the "Laser Prep" file) by 
  5.  hitting Command-K WHILE MOUSING DOWN on OK from the LaserWriter Print 
  6.  dialog, or a file without the library code by hitting Option-F.  
  7.  Option-K and Command-F may do one or the other (??). 
  8.  
  9. Unfortunately, the Laser Prep code includes a few features that make 
  10.  the Command-K file unusable on certain non-Apple laser printer systems, 
  11.  such as a DEC ScriptPrinter connected to a VAX.  
  12.  
  13. The AddLPrep program remedies this situation by adding a modified version 
  14.  of the PostScript code from the Laser Prep file to a PostScript file 
  15.  created by hitting Option-F.
  16. The output file produced by AddLPrep is thus suitable for
  17.  downloading to any PostScript printer or typesetter.
  18.  
  19. This version (1.1) differs from 1.0 only in that it works with  
  20.  System 6.0 (AppleDict 68) as well as System 5.0 (AppleDict 65).
  21.  
  22. VERY IMPORTANT: AddLPrep is SHAREWARE and is copyright ⌐ 1988 by 
  23.  Software101, Los Gatos, CA.  Feel free to try it out and give 
  24.  copies to others, but if you find the program useful and continue 
  25.  to use it, send $20 to Software101, 15151 Old Ranch Road, Los Gatos, 
  26.  CA  95030.  As indicated below, this program may need considerable 
  27.  support; problems will be solved only for those who have paid 
  28.  for the program.  Someday, in some manner, new versions may be 
  29.  available only to those honest folks.
  30.  
  31. "Thank you for your support"
  32.                     -- Bartles & Jaymes, 1986
  33.  
  34. ALSO VERY IMPORTANT: The contents of the Laser Prep file are copyrighted 
  35.  by Apple Computer, and using the output of this program for any 
  36.  purpose other than 1) downloading to a PostScript printer, or 
  37.  2) study of PostScript programming techniques, is almost 
  38.  certainly a violation of that copyright.
  39.  
  40. GETTING READY:
  41. Since you're reading this, you've already mastered the first step:
  42. unpacking the distribution (.sit) file using the Stuffit program.
  43. There are two versions of AddLPrep in this package; one is an application
  44. that can be started from the Finder, the other is a Desk Accessory that
  45. can be selected from the Apple menu while using any program that supports
  46. Desk Accessories (most do).
  47.  
  48. If you want to use the Desk Accessory version, the next step is to
  49. use Apple's Font/DA Mover program to move the contents of the AddLPrepDA
  50. file to your System file.  If you don't have a hard disk, you'll need 
  51. to transfer it to the System files on all the floppies you want to use 
  52. it with.
  53.  
  54. In order to use either version, you must have a copy of the LaserWriter
  55. driver and the matching Laser Prep file in your System Folder (if you
  56. dont have a hard disk, in the System Folders on all the floppies you want 
  57. to use it with.
  58.  
  59. OPERATION: 
  60.  1) If necessary, use the Chooser DA to select the LaserWriter.
  61.     You don't have to actually have a LaserWriter connected to 
  62.     your Mac, but if you have an ImageWriter or something else
  63.     connected to your serial Printer port, be sure to turn its
  64.     power off before you use Chooser!
  65.  2) Start the application that produces the printout you want,
  66.     and open the document you want to print.  Or, just double-
  67.     click on the document from the Finder.  Or, most elegantly,
  68.     single-click on the document and choose Print from the Finder's
  69.     File menu.
  70.  3) Unless you did so from the Finder, choose Print from the 
  71.     application's File menu.
  72.  4) After selecting whatever options you want from from the LaserWriter 
  73.     Print dialog, press the mouse button down on the OK button AND HOLD 
  74.     IT DOWN!!  Now, while holding it down, hit Option-F on the keyboard. 
  75.     With some programs it may be necessary to hold Option and F down 
  76.     for a short while so as to "repeat" the key strike.  Then release 
  77.     the mouse button.
  78.  5) You should see a message box near the top of the screen saying 
  79.     something like "Creating PostScript file".  A disk file will be 
  80.     created named "PostScriptn", where n is most often 0.  Depending on 
  81.     the application, the file may end up in the System Folder, the folder 
  82.     the application is in, or (?) somewhere else.  You may have to use 
  83.     the Find File DA to find it.
  84. 6A) WITH THE APPLICATION VERSION OF AddLPrep:
  85.     * Quit the application.
  86.     * In the Finder, you may want to rename the file to something 
  87.       more meaningful.  
  88.     * Run the addLPrep application.
  89. 6B) WITH THE DESK ACCESSORY VERSION:
  90.     * Choose AddLPrep from the Apple menu.
  91.  7) With either version, a standard file selection box appears.  Choose 
  92.     the file created in steps 4-5, and double-click on it, or click on 
  93.     Open, or hit Return.
  94.  8) A new dialog box then appears, telling you that AddLPrep is converting
  95.     your file, and the cursor changes to a watch.  Depending on how long 
  96.     and complex your printout is and what kind of Mac you have, the 
  97.     process may take a few seconds to several minutes.  You can cancel
  98.     the process by clicking on the button in the dialog box, or holding 
  99.     down the Command (Apple) key and pressing the '.' key.
  100.  9) When it's done, the application version will quit to the Finder,
  101.     while the DA version will just go away.  Unless you cancelled, there 
  102.     is then another new file, with the same filename plus ".ps" at the end.
  103.     This is a complete PostScript file (program) suitable for direct 
  104.     downloading to any PostScript printer or typesetter.
  105.  
  106. TECHNICAL NOTE:
  107. AddLPrep substitutes the Laser Prep code for a line starting with:
  108. %%IncludeProcSet: "(AppleDict md)"
  109. If the input file does not contain a line like this, then AddLPrep
  110. produces an Alert box noting that it has just functioned as a text file
  111. duplicating program.  (This will not occur for files created by Option-F
  112. as described above.)
  113.  
  114. ABOUT RELIABILITY:
  115. As AddLPrep transfers the PostScript code from the Laser Prep
  116. file to the output file, it makes a few modifications to the code
  117. to make it suitable for use as a "transient" program that doesn't 
  118. "take over" the printer or modify its state.  AddLPrep has been 
  119. tested with a number of common Mac applications and with a DEC 
  120. ScriptPrinter.  However, it may prove unreliable in any of the 
  121. following cases:
  122.  
  123. a) when used with a version of Laser Prep other than the ones 
  124.    distributed with Apple's System Software 5.0 and 6.0 (a.k.a. System 
  125.    4.2/Finder 6.0 and 6.0/6.1 respectively).  Internally, the code in  
  126.    these files is called version 65 and 68 respectively.  If the Laser
  127.    Prep file is sufficiently different, AddLPrep will detect the problem
  128.    and show an Alert box.  Or,
  129.  
  130. b) when used with a different PostScript printer, or
  131.  
  132. c) when used with applications other than those the author has tested
  133.    it with, or
  134.  
  135. d) when used with documents that contain graphic shapes other than 
  136.    those the author happens to have tested (e.g., arcs have not been
  137.    tested).
  138.  
  139. The most likely source of problems is a), for future versions of Laser 
  140. Prep.
  141.  
  142. Problems can be reported to the author via EMail to CompuServe
  143. 72367,2599 or GEnie MACKENNA, but please be patient.  Assuming a ".ps" 
  144. file was produced and it's less than, say, 32Kbytes long, upload it on 
  145. EMail along with the description of the problem.  
  146.  
  147. If you have a problem with a huge PostScript file, try to reproduce it 
  148. in a small file.  For multi-page printouts, a problem is automatically
  149. isolated to the first page that doesn't print out, and other pages can 
  150. be deleted from the PostScript file.  The start of each page is marked 
  151. by a line like
  152. %%Page: n
  153. Always keep the part of the file before the start of page 1.
  154.  
  155. To isolate problems further, try inserting lines like 
  156.    (we got to here) print
  157. in the PostScript code.  The messages before the problem will come back
  158. from the PostScript printer, before the error message.  Warning: figuring
  159. out where to put those lines may turn you into a PostScript programmer!
  160.